When running Citrix, a Citrix icon Citrix is added to the Windows System Notification tray, which is located on the far right side of the Windows taskbar (beside the time / date). If you do not see the Citrix icon, click the arrow in the System Notification Tray to reveal all available icons:

Reveal icons

Right-click the Citrix icon and select Connection Centre from the menu that displays.
The Citrix Connection Centre will display with a list of active Citrix sessions:
Select your session and click Terminate.

Columns & Fields

How do I find the back-end / column name for a field?

What is the difference between a column and a field?

Condition Checks

How do I perform a bulk condition update?

Customising EMu

Can EMu be customised to timeout searches?

Can I change the display language in EMu?

Can I change the System and interface options?

How do I configure a new Page View?

How do I customise the Field Level Help?

How do I configure Notification reports?

Can I add a link in the field level help that takes users to related information (a web page or a page in the EMu Help)?

Data format

What are the date and time formats?

How do I define date formats?

Date and Time

How do I enter the current date and time?

What date and time formats are available in EMu?

Default Values

What are default values?

How do I specify default values?

How do I modify default values?

How do I reload default values?

How do I select a set of default values?

Delete

How do I remove rows from a table?

Why can't I delete this record?

Dialogue boxes

Can I copy an item in a dialogue box?

Displaying records

How do I configure the Contact Sheet View?

How do I configure a new Page View?

Editing records

How do I do a Global Replace?

How do I locate an empty field and replace it with a value? (See Step 5)

Why can't I edit records (multi-language environment)?

What is Record Recall functionality?

How do I use Record Recall to replace the current record with an earlier version of the record?

How do I use Record Recall to return a batch of records to an earlier state?

Error messages

What does this error message mean?

What version of EMu am I using?

When I try to access a Resource on the Tools tab of the Ribbon, I get an error message similar to: "A semi colon character was expected line 1, column 105". Why?

Field changes

How do I view changes to fields?

Global Replace

How do I do a Global Replace?

How do I locate an empty field using the Global Replace tool?

How do I locate an empty field and replace it with a value? (See Step 5)

How do I substitute one attachment with another?

How do I remove rows from a table?

Is it necessary to escape wildcards in EMu 5.0 onwards?

Groups

How do I create or edit a group in the Groups module?

How do I create or edit a group using the Tools>Group options from a module Menu bar?

How do I set permissions for a group?

How do I retrieve a group using the Groups module?

How do I retrieve a group using the Tools>Group options from a module Menu bar?

How do I delete a group from the Groups module?

Help & Field Level Help

Why does the version of EMu used in this Help look different to the version I'm using?

Field Level Help

How do I customise the Field Level Help?

How do I give users permission to edit Field Level Help?

Can I display different Field Level Help to different groups?

Can I add a link in the field level help that takes users to related information (a web page or a page in the EMu Help)?

How do I add field help descriptions in different languages in a multi-language environment?

Why can't I edit the Field Level Help description?

Hosting

How do I connect to a hosted EMu service?

What do I do if I can't disconnect my connection (error Number 310)?

Images

How do I print an image?

How do I scan an image into EMu?

Importing & updating records: the Import tool

What is the Import tool?

How do I import records into EMu?

What Registry settings need to be set for a user to import records into EMu using the Import tool?

How do I escape an ampersand character in XML?

How do I load multimedia using the Import tool?

How do I update records in EMu?

How do I use XSLT to process the import of XML?

Indexing

How do I view details about System Indexing?

What is Range Indexing and how does it work?

What are the Range Indexing Registry entries?

What is the emurangeupdate utility and how do I use it?

Language

How do I change the display language?

Why can't I edit records (multi-language environment)?

Logging in and out of EMu

How do I log in to / out of EMu?

How do I connect to a hosted EMu service?

Lookup Lists

How do I select a value from a Lookup List?

How to add a value to a Lookup List

Can I include punctuation in a Lookup List value?

Modules

Multimedia

What are the Multimedia Registry settings?

How do I add an image to a report?

What image formats are available in EMu?

What audio and video support is available in EMu?

What metadata standards are supported?

An image has metadata but it was added to EMu before EMu had support for metadata. How do I add the metadata in the image to the Multimedia module?

Is it possible to search the content of attached text documents?

Narratives

How do I use the Narratives module?

How do I use the Narratives module as the content management system for a website?

Passwords

How do I change my password (for users)?

How do I manage passwords in EMu (for System Administrators)?

What do I do if I've forgotten my password?

Permissions

Why haven't the changes I've made to user / group permissions taken effect?

Record Level Security

What is Record Level Security?

How do I search for a record for which a user / group had permissions assigned, but the user / group has been removed from EMu?

Why can't I change the permissions on the Security tab?

Why can't I locate records I know are there? Why, using the same search criteria, are my search results different from those of my colleague?

Why does this field show as "Restricted"?

Record Recall

What is Record Recall functionality?

How do I use Record Recall to replace the current record with an earlier version of the record?

How do I use Record Recall to return a batch of records to an earlier state?

What permissions do I need to use Record Recall?

How do I specify that one or more fields are not updated during a Record Recall operation?

Record Templates

What are Record Templates?

How do I create records using Record Templates?

How do I create Record Templates?

Recording objects

How do I record parent / child objects?

How do I record pre-acquisition objects?

Registry

What are the EMu Registry settings?

Why haven't the changes I've made to user / group permissions taken effect?

Reports

How do I create a report?

How do I add an image to a report?

Why don't all the records I've reported on display in my Crystal report?

Resources

How do I use Resources?

How do I register Resources?

When I try to access a Resource on the Tools tab of the Ribbon, I get an error message similar to: "A semi colon character was expected line 1, column 105". Why?

Can EMu be customised to timeout searches?

How can I make my search case sensitive?

How do I configure the Also Search function?

How do I copy and paste multiple values into a search field?

How do I search attachment fields?

How do I search for a record for which a user / group had permissions assigned, but the user / group has been removed from EMu?

How do I search for a wildcard character?

How do I search for an empty field?

How do I search for attachments / no attachments in an attachment field?

How do I search for punctuation?

How do I search on latitude and longitude?

How do I turn on / off auto sorting of search results?

Is it possible to search the content of attached text documents?

Why can't I locate records I know are there? Why, using the same search criteria, are my search results different from my colleagues?

What is the Also Search function?

Why doesn't my NOT search return every record without the excluded search term (it does not return records with no value in the searched field)?

Why doesn't my range search appear to return the correct results?

Why does this field show as "Restricted"?

Sort

How do I turn on / off auto sorting of search results?

Why can't I sort using this field?

System information

What are the minimum System requirements for EMu?

What version of EMu am I using?

Tabs

How do I find the back-end name of a tab?

Tables

How do I remove rows from a table?

Tasks

How do I add a task to a record?

How do I create a Task Template?

How do I use a Task Template?

Taxonomy

How do I add a record to the Taxonomy module?

How do I build a hierarchy for a taxonomic name?

How do I record a hybrid?

How do I record a cultivar name?

UNICODE

How do I add a Unicode character to EMu?

How do I map a code point (e.g. œ) to a compatible code point (e.g. oe)?

User management

How do I define user and group access permissions?

How do I manage passwords in EMu (for System Administrators)?

Why haven't the changes I've made to user / group permissions taken effect?

Working with records

How do I add a new record?

How do I save a record?

Why can't I save a record?

How do I search EMu?

How do I sort records?

How do I group records?

Can I copy values from one record into another record?

Why can't I change the permissions on the Security tab?

How do I search for a record for which a user / group had permissions assigned, but the user / group has been removed from EMu?

Why can't I locate records I know are there? Why, using the same search criteria, are my search results different from those of my colleague?

Why does this field show as "Restricted"?

How do I import records into EMu?

XML

How do I escape an ampersand (&) character in XML?

Error Messages

A semi colon character was expected

Example Error Message:

A semi colon charcater expected

Why this message is displayed:

The Microsoft XML parser used by EMu requires the ampersand (&) character in a Resource definition to be specified as:

&

For instance, the following is required:

hl=en&q=%22

What to do now:

In the Resource definition in the Registry module, locate the ampersand character and replace it with &

A value is required: Mandatory field error

Example Error Message:
Why this message is displayed:	You have tried to save a record without entering a value into a mandatory field.
What to do now:	Enter a value in the mandatory field and then save the record.

Accessing a system designed for a different client

Example Error Message:

Different Client

Why this message is displayed:

A common problem encountered in multi-client environments (servers that support more than one client type) is connecting a client to an incompatible server. When this occurs most modules will function correctly except for client specific modules. EMu provides a mechanism for checking that a client has connected to a compatible server.

What to do now:

Check that you have typed the correct service name or number in the Host box of the EMu Login box.

If this does not resolve the problem, contact your Systems Administrator who should investigate:

Which server version is in use.
That the ServerPath EMu Registry entry is correct.

Accessing a system designed for a Later version

Example Error Message:

Why this message is displayed:

The server you are connecting to was designed for an older client than the one you are using. There is potential that modifications to the client are incompatible with the server.

What to do now:

Check that you have typed the correct service name or number in the Host box of the EMu Login box.

If this does not resolve the problem, contact your Systems Administrator who should investigate compatibility of the client and server versions. It may be that the version of the client is older than the version specified by the Version Registry entry.

Accessing a system designed for an older client

Example Error Message:

Why this message is displayed:

The server you are connecting to was designed for an older client than the one you are using. There is potential that modifications to the client are incompatible with the server.

What to do now:

Check that you have typed the correct service name or number in the Host box of the EMu Login box.

Cannot delete record

Example Error Message:

Why this message is displayed:

You are trying to delete a target An attachment is made from one record to another. The record from which the attachment is initiated is the Primary record; the record that is attached is called the Target.record. It is not possible to delete a record if another record has made an attachment to it.

What to do now:

Before the record can be deleted it is necessary to remove the attachment to it.

See Reverse attachments and how to work with them for details.

Cannot receive from remote host (Number 309)

Why this message is displayed:

Your computer entered power save mode and on waking could not connect to the server.

What to do now:

For users the solution is simply to log out of EMu and log back in.

For System Administrators in organisations which have implemented a power save policy, there are mechanisms to prevent this issue occurring, however each solution has consequences as described below.

Explanation

By default, the EMu server pings the EMu client connections every 60 seconds to determine if the connection is still up and active. When a PC is powered down while still connected to EMu the ping gets no response and the connection is terminated and the EMu licence for that connection is freed up (and users receive this error message when attempting to resume their session).

Solutions

It is possible to disable the ping by editing the inetd.d or xinetd.d file (e.g. /etc/xinetd.d/emuclientname) and remove the -t 60 from the server_args parameter and then restart the xinetd service. This will maintain connectivity. However, the server will not know if the user has switched off their PC and gone home or the PC has powered down. The licences will not be freed up and you will end up with licencing problems.
Alternatively, the ping duration could be increased to an hour (for instance). When a PC is powered down for less than an hour the connection will still be active, otherwise it will be terminated. In the instance where a PC is shut down, the connection and licence will not be freed till the hour is up.

Cannot send to remote host

Example Error Message:
Why this message is displayed:	Your EMu server or LAN is down.
What to do now:	Contact your System Administrator.

Cannot send to remote host (Number 310)

Why this message is displayed:	You have attempted to end your connection to a hosted service and are unable to terminate the session.
What to do now:	Press `CTRL+ALT+End`. A screen similar to the following will display: Select Sign out to close the connection.

Newer version of record exists

Example Error Message:

Refresh record

Why this message is displayed:

You have generated a search and downloaded a group of records onto your PC. In the meantime, another user has edited one of the records.

What to do now:

To view the latest version of the record, click Yes.

To view the version of the record at the time that you ran your search, click No.

Operational privileges not defined

Example Error Message:
Why this message is displayed:	There is no default Registry entry defining your operational access to this table or your username has not been placed in the correct group The set of access permissions shared by one or more users..
What to do now:	Contact your Systems Administrator.

bad column name

Example Error Message:
Why this message is displayed:	The incorrect column or field name was entered in a Registry entry. Details about the type of permission are provided in the message (in this example a Column Colour Registry entry has a misspelled column name).
What to do now:	Contact your Systems Administrator and provide the message details so they can locate the Registry entry and correct the column name.

Record is being edited

Example Error Message:
Why this message is displayed:	You are trying to make changes to a record that another user is currently editing.
What to do now:	If another user is editing the record, wait until the other user has finished using the record. You will need to refresh your record so that you view the latest data.

Table is closed

Example Error Message:
Why this message is displayed:	A table you are trying to access is closed. Maintenance on the table may be in progress.
What to do now:	Contact your Systems Administrator who needs to bring the table back online.

Unique-valued field error

Example Error Message:
Why this message is displayed:	You have entered a duplicate value in a field that has been set to have unique values only.
What to do now:	Edit the value to make it unique.